home *** CD-ROM | disk | FTP | other *** search
/ Aminet 22 / Aminet 22 (1997)(GTI - Schatztruhe)[!][Dec 1997].iso / Aminet / util / time / BenchClock.readme < prev    next >
Encoding:
Text File  |  1997-11-02  |  5.8 KB  |  184 lines
  1. Short:    BenchClock V1.55 - Real Digital Clock for WB or any PubScreen
  2. Author:   pliukko@jmp.fi (Pertti Liukkonen)
  3. Uploader: pliukko@jmp.fi (Pertti Liukkonen)
  4. Version:  1.55
  5. Type:     util/time
  6. Requires: OS 2.04+
  7. Replaces: util/time/BenchClock.lha
  8.  
  9. BenchClock 
  10. ----------
  11. A small and very configurable digital clock for Workbench or any
  12. Public Screen. 100% Assembly coded.
  13.  
  14. Fourth public release 16 Oct 1997, V1.55 Freely Distributable FREEWARE
  15. BenchClock (C) 1997 Peolli productions (Pertti Liukkonen)
  16.  
  17. What's New? - look 'History'!
  18.  
  19. Requirements
  20. ------------
  21. Kickstart 2.04 or better.
  22.  
  23.  
  24. OPTIONS (32 TOOLTYPES)    
  25. -----------------------
  26. PUBSCREEN        Name of Public Screen where the window should be opened
  27.                  If NULL, window will opened in a default public screen
  28. BACKDROP         Backrop-style window
  29. STAYFRONT        Window stays on front of all the other windows 
  30. BORDERLESS       Borderless window
  31.  
  32. LEFT             The position of window's left edge. (>=0)
  33. TOP              The postiton of window's top edge (>=0)
  34. DIGWIDTH         Width of the digits  (>=1)
  35. DIGHEIGHT        Height of the digits (>=1)
  36.  
  37. 12HOURS          12 hour mode, AM/PM will be added
  38. SECONDS          Displays seconds
  39. UPDATESECS       Delay between updates
  40.  
  41. NOCLOSEGADGET    Hides close gadget 
  42.                  (program can be always closed via menus)
  43. NODEPTHGADGET    Hides depth gadget
  44. NODRAGBAR        Hides window dragbar
  45. NOWINTITLE       Hides window title
  46.  
  47. VERSEGSIZE       Size of the vertical segments  (1-3 pixels)
  48. HORSEGSIZE       Size of the horizontal segments (1-3)
  49. MIDSEGSIZE       Size of the middle segment (1-3)
  50.  
  51. BGCOLOR          Background color (>=0)
  52. SHDWCOLOR        Shadow color (unused segments) (>=0)
  53.  
  54. COLONFGCOLOR     Colon Foreground color (>=0)
  55. SECFGCOLOR       Foreground color for seconds (>=0)
  56. MINFGCOLOR       Foreground color for minutes (>=0)
  57. HOURFGCOLOR      Foreground color for hours (>=0)
  58. AMPMCOLOR        Color for AM/PM (>=0)
  59.  
  60. COLONBLINK       Makes colons to blink
  61.  
  62. EXTRABORDER      Draws extra border around the display. Currently only
  63.                  one type (=1). For best results adjust XSPACE and YSPACE.
  64. EBCOLOR1     Color #1 for EXTRABORDER
  65. EBCOLOR2     Color #2 for EXTRABORDER
  66.  
  67. SPACE            The space between hours-minutes-seconds (>=0)
  68. XSPACE           The space between the numbers and the window's vertical
  69.                  borders (>=0)
  70. YSPACE           The space between the numbers and the window's horizontal 
  71.                  borders (>=0)
  72.  
  73. Menus
  74. -----
  75. If you have set NOCLOSEGADGET, you can quit BenchClock from the Main menu.
  76. Also STAYFRONT can be enabled/disabled from the Options menu. 
  77.  
  78. Installation
  79. ------------
  80. Copy the program (BenchClock) and the icon (BenchClock.info) to WbStartup
  81. or anywhere you like.
  82.  
  83.  
  84. Usage
  85. -----
  86. Program can be launched from Workbench or CLI.
  87.  
  88. Workbench: Double click the BenchClock Icon
  89. CLI:       BenchClock <iconfilename> NOTE: filename WITHOUT ".info"!
  90.  
  91. NOTICE: When you run the BenchClock from the CLI, prefs will be loaded
  92. from the default icon file (<Program name> + ".info")
  93. You can also specify other icon file, for example typing in command line:
  94. BenchClock temp:icons/BC2 (opens BC2.info file) 
  95.  
  96. Configuration has to be made using tooltypes.
  97.  
  98.  
  99. Known Bugs
  100. ----------
  101. None.
  102.  
  103. Use reasonable values only with the tooltypes! It shouldn't crash your 
  104. system, if you use it right. But it may, so please inform me about any 
  105. bugs. When an error occures BenchClock doesn't print out any messages.
  106.  
  107. I don't take any responsibilities of any damage on your system that 
  108. BenchClock may cause.
  109.  
  110.  
  111. Future Improvements
  112. -------------------
  113. Because I want to keep the executable quite small and limit the memory 
  114. usage, only few improvement will be made. Some ideas:
  115.  
  116. - More configurable (borders, colon/digit/segment sizes and styles) 
  117. - Date, alarm
  118.  
  119. These are coming, but not very soon. I have also other projects going on.
  120. Your suggestions are always welcome.
  121.  
  122. - And of course bug fixes, if there founds any.
  123.  
  124.  
  125. History
  126. -------
  127. V1.55 Fourth public release 16 Oct 1997.
  128.       Bug fixed: V1.54 didn't free all memory in 24 hour mode.
  129.       Added Benchclock.guide
  130.  
  131. V1.54 Third public release 14 Oct 1997.
  132.       Bug fixed: Program caused some BYTE-READ Enforcer hits in startup
  133.       (Silly, but not so dangerous bug.)
  134.       Added full window dragging. It's possible to move a NODRAGBAR 
  135.       window now. Some optimizations.
  136.  
  137. V1.53 Minor changes. Added stayfront menu shortcut. 
  138.  
  139. V1.52 Second public release 13 Oct 1997. 
  140.       Added EXTRABORDER, EBCOLOR1 and EBCOLOR2. New Options menu with
  141.       Stayfront toggle. Tooltypes reorganized. Some minor code changes.
  142.  
  143. V1.51 Bug fixed: STAYFRONT was incompatible with PowerSnap; snapping
  144.       was interrupted in updates. Reported by Fredrik Ismyren, thanks! 
  145.  
  146. V1.5  First public release
  147.  
  148. V1.0 - V1.4 Internal beta versions
  149.  
  150.  
  151. Thanks
  152. ------
  153. o To all BenchClock users and bug reporters!
  154. o Tommi Liukkonen for beta testing and some ideas.
  155. o Amiga - Only Amiga makes it possible.
  156.  
  157.  
  158. Author
  159. ------
  160. Feel free to contact for any reason:
  161.  
  162. Peolli productions (Pertti Liukkonen), Finland
  163. Email : pliukko@jmp.fi
  164. URL   : http://www.jmp.fi/~pliukko/   
  165. (Homepage is not ready yet, but will be there at the end of Oct '97)
  166.  
  167. I'm also very interested in how many BenchClock users there is...
  168. so please send some email if you are using it!
  169.  
  170. My english is not perfect, but I hope you got the point ;)
  171.  
  172.  
  173. ============================= Archive contents =============================
  174.  
  175. Original  Packed Ratio    Date     Time    Name
  176. -------- ------- ----- --------- --------  -------------
  177.     8936    4619 48.3% 15-Oct-97 10:44:52  BenchClock
  178.     6189    2715 56.1% 15-Oct-97 10:57:56  BenchClock.guide
  179.      503     259 48.5% 15-Oct-97 11:02:14  BenchClock.guide.info
  180.     2947     629 78.6% 15-Oct-97 11:02:14  BenchClock.info
  181.     5401    2477 54.1% 15-Oct-97 11:09:34  BenchClock.readme
  182. -------- ------- ----- --------- --------
  183.    23976   10699 55.3% 16-Oct-97 04:02:02   5 files
  184.